home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / qm3ext.arc / DSZ.DOC < prev    next >
Text File  |  1987-03-15  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           dsz - YMODEM, ZMODEM PC-DOS file transfer subprogram
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ddddsssszzzz [CCCCOOOONNNN] [ppppoooorrrrtttt NNNN] [ssssppppeeeeeeeedddd SSSS] [dddd] [rrrreeeessssttttrrrriiiicccctttt] _c_o_m_m_a_n_d
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _D_s_z uses the YMODEM or ZMODEM error correcting batch
  16.           protocol to transfer files over a serial port with a variety
  17.           of programs.  _D_s_z is designed to be called from a
  18.           communications program or bulletin board to perform file
  19.           transfers.
  20.  
  21.           _D_s_z uses its own modem I/O.  The original interrupt vector,
  22.           UART interrupt configuration, and 8259 interrupt mask are
  23.           restored on exit.  The March 1987 version buffers both
  24.           transmitted and received data, providing enhanced throughput
  25.           with multi taksing systems such as DESQview.
  26.  
  27.           _D_s_z uses DOS standard output for messages, it does not write
  28.           directly to the screen.  _D_s_z expects its standard output to
  29.           point to the console, a logging file, or NULL, not the modem
  30.           port.  It may be redirected to the console device with the
  31.           CCCCOOOONNNN command.
  32.  
  33.           _D_s_z exits with 0 status for successful transfers, 1 if the
  34.           file transfer failed.
  35.  
  36.           The available commands are:
  37.  
  38.           CCCCOOOONNNN  Redirect message output to the DOS "CON" (console)
  39.                device, overriding any previous redirections.
  40.           ppppoooorrrrtttt NNNN
  41.                select port N (n = 1,2,3 or 4) Default is port 1 (COM1)
  42.                or read from the DDDDSSSSZZZZPPPPOOOORRRRTTTT dos environment variable.
  43.           ssssppppeeeeeeeedddd SSSS
  44.                Set specified speed, default is the port's current
  45.                speed.
  46.           dddd    Disables carrier dropout monitoring, for modems that do
  47.                not properly drive the "Data Carrier Detect" input on
  48.                the PC.
  49.           LLLLAAAARRRRGGGG Convert AAAARRRRGGGG to lowercase, then parse aaaarrrrgggg....
  50.           ppppxxxxNNNN  Set a numeric parameter xxxx to N.  These parameters
  51.                correspond to the Pro-YAM or ZCOMM "zmodem" parameters
  52.                and rarely need changing.  These parameters assume
  53.                their defaults each time _d_s_z is called.
  54.           rrrreeeessssttttrrrriiiicccctttt
  55.                Restrict pathnames to current disk and directory tree.
  56.           sssszzzz   [-Vabnpr+y] [PREFIX=p | ONAME=n] afn ...
  57.           ssssbbbb   [-Vk] [PREFIX=p | ONAME=n] afn ...
  58.           rrrrzzzz   [-Vabnpr+y]
  59.           rrrrzzzz   [-Vabnpr+y] file1 file2 ...  (filename override)
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 3/15/87)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.           rrrrbbbb   [-Vab+y]
  75.           rrrrbbbb   [-Vab+y] file1 file2 ...  (filename override)
  76.           ----VVVV   Dsiplay debugging information.  More V's give more
  77.                detailed information.
  78.  
  79.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  80.           dsz sz -r b:zcom*.arc c:foo.bar
  81.  
  82.           dsz port 2 speed 19200 restrict rz
  83.  
  84.           dsz  rz  -y newprog.arc   (single file with pathname
  85.           override)
  86.           DSZ LRZ L-Y NEWPROG.ARC   (command line forced to upper
  87.           case)
  88.  
  89.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.           Consult the Professional-YAM or ZCOMM manual chapter
  91.           "Options for File Transfers" for option meanings.  The "File
  92.           Transfer Basics" chapter explains the relative merits of the
  93.           XMODEM, YMODEM, and ZMODEM protocols.  The "Main Commands"
  94.           chapter describes the rb, rz, sb, and sz commands.
  95.  
  96.      NNNNOOOOTTTTEEEESSSS
  97.           _D_s_z sets the UART shift register to 8 bits no parity; the
  98.           original parity setting (if different) is not restored on
  99.           exit.
  100.  
  101.           32 bit CRC code courtesy Gary S. Brown.
  102.  
  103.      FFFFIIIILLLLEEEESSSS
  104.           ZCOMMDOC.ARC, ZCOMMEXE.ARC, ZCOMMHLP.ARC, ZMODEM.ARC
  105.  
  106.      LLLLIIIICCCCEEEENNNNSSSSEEEE
  107.           _D_s_z is written by Chuck Forsberg.  _D_s_z may be freely used
  108.           and copied, but not modified or sold without the written
  109.           permission of Omen Technology Inc.  As a courtesy to the
  110.           author, bulletin board systems using _d_s_z are requested to
  111.           feature the ZCOMM files (ZCOMMEXE.ARC, ZCOMMDOC.ARC,
  112.           ZCOMMHLP.ARC) for unrestricted downloading.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 3/15/87)
  130.  
  131.  
  132.  
  133.